home *** CD-ROM | disk | FTP | other *** search
/ HyperLib 1997 Winter - Disc 1 / HYPERLIB-1997-Winter-CD1.ISO.7z / HYPERLIB-1997-Winter-CD1.ISO / オンラインウェア / COM / BIGSURF Netguide 3.3.sit / BIGSURF Netguide 3.3 / 21-1-IRC_Primer < prev    next >
Text File  |  1993-10-06  |  79KB  |  2,089 lines
  1. <HTML>
  2. <HEAD>
  3. <TITLE>A Brief IRC Primer - EVERYTHING You Need To Know</TITLE>
  4. </HEAD>
  5. <BODY BACKGROUND=BACKGRND.JPG>
  6. <HR>
  7. <CENTER><H1>IRC Information</H1></CENTER>
  8. <HR>
  9.  
  10.  
  11. <CENTER><H2>A Short IRC Primer - Edition 1.1b</H2></CENTER>
  12. <HR>
  13.  
  14. <CENTER>Written by Nicolas Pioch,  (Nap on IRC) - <A HREF="mailto:Nicolas.Pioch@grasp.insa-lyon.fr">Nicolas.Pioch@grasp.insa-lyon.fr</A></CENTER><BR>
  15.  
  16. <CENTER>Text conversion by Owe Rasmussen,  (Sorg on IRC) - <A HREF="mailto:d1rasmus@dtek.chalmers.se">d1rasmus@dtek.chalmers.se</A></CENTER>
  17. <HR>
  18. <CENTER><H3>Abstract</H3></CENTER>
  19. <HR>
  20.  
  21. <P>
  22. Have  you ever wanted to talk with other computer users in other parts
  23. of  the  world?  Well guess what...  You can!  The program is called IRC,
  24. (Internet  Relay Chat), and it is networked much over North America, Asia
  25. Europe, and Oceania.  This program is a substitution for 'talk', and many
  26. other  multiple  talk  programs  you might have read about.  When you are
  27. talking  on IRC, everything you type will instantly be transmitted around
  28. the  world  to  other users that might be watching their terminals at the
  29. time, they can then type something and respond to your messages, and vice
  30. versa.  I should warn you that the program can be very addictive once you
  31. begin  to make friends and contacts on IRC, especially when you learn how
  32. to discuss in 14 languages...
  33.  
  34. <P>
  35. Topics of discussion on IRC are varied, just like the topics of Usenet
  36. newsgroups  are varied.  Technical and political discussions are popular,
  37. especially  when  world  events  are  in  progress.  IRC is also a way to
  38. expand  your horizons, as people from many countries and cultures are on,
  39. 24  hours a day.  Most conversations are in English, but there are always
  40. channels  in  German,  Japanese,  French, Finnish, and occasionally other
  41. languages.
  42.  
  43. <P>
  44. IRC  gained  international fame during the late Persian Gulf War, when
  45. updates  from  around  the world came across the wire, and most people on
  46. IRC gathered on a single channel to hear these reports.
  47. <HR>
  48.  
  49.                                 <CENTER><H3>CONTENTS</H3></CENTER>
  50. <HR>
  51. <OL>
  52. <LI>Getting started
  53.  
  54. <OL>
  55. <LI>Clients and Servers
  56. <LI>How to Behave on IRC
  57. <LI>Privacy on IRC
  58. <LI>First Steps
  59. <LI>Screen and Keyboard activity
  60. </OL>
  61.  
  62. <LI>Let's go!
  63.  
  64. <OL>
  65. <LI>General Commands
  66. <LI>Communication and Private Conversations
  67. <LI>Channels and Public Conversations
  68. <LI>Channel and User Modes
  69. <LI>Client to Client Protocol
  70. <LI>Network Related Commands
  71. <LI>Quick Reference Panel
  72. <LI>Further into ircII Wizardry
  73. <LI>Sample .ircrc
  74. <li>Writing Automatons
  75. </OL>
  76.  
  77.  
  78. <LI>Frequently Asked Questions
  79.  
  80. <OL>
  81. <LI>How do I set up an IRC client?
  82. <LI>Which server do I connect to?
  83. <LI>What are good channels to try while using IRC?
  84. <LI>How do I get nifty effects with ircII?
  85. <LI>What if someone tells me to type something cryptic?
  86. <LI>I get strange characters on my screen, what are they?
  87. <LI>What about NickServ?
  88. <LI>I'm being flooded and harassed by a jerk. Help!
  89. <LI>How do I get rid of a ghosted IRC session?
  90. <LI>About KILL usage.
  91. <LI>Where can I find more?
  92. </OL>
  93.  
  94. <LI>Administrativia
  95.  
  96. <OL>
  97. <LI>Revision history
  98. <LI>Release sites for the IRCprimer
  99. <LI>Copyright (C) 1993 Nicolas PIOCH
  100. <LI>Credits
  101. </OL></OL>
  102. <HR>
  103.                              <CENTER><H3>List of Tables</H3></CENTER>
  104. <HR>
  105.  
  106.            <UL>
  107. <LI> Table  1:  Editing keys
  108. <LI>           Table  2:  Editing commands
  109. <LI>           Table  3:  Simple screen activity
  110. <LI>           Table  4:  General commands
  111. <LI>           Table  5:  Private conversation commands
  112. <LI>           Table  6:  Channel commands
  113. <LI>           Table  7:  Mode commands
  114. <LI>           Table  8:  Channel modes
  115. <LI>           Table  9:  User modes
  116. <LI>           Table 10:  Client to client commands
  117. <LI>           Table 11:  Network related commands
  118. <LI>           Table 12:  Setting environment tables
  119. <LI>           Table 13:  Environment variables
  120. <LI>           Table 14:  Advanced commands
  121. <LI>           Table 15:  FTP sites with IRC clients
  122. <LI>           Table 16:  Open telnet IRC clients
  123. <LI>           Table 17:  Open IRC servers
  124. <LI>           Table 18:  Highlighting ircII output
  125. <LI>           Table 19:  Nordic countries character translations
  126. <LI>           Table 20:  IRC related mailing lists
  127. <LI>           Table 21:  IRCprimer release sites
  128. </UL>
  129. <HR>
  130. <CENTER><H2>1. GETTING STARTED</H2></CENTER>
  131. <HR>
  132.  
  133.                         <CENTER><H3>1.1 Clients and Servers</H3></CENTER>
  134. <HR>
  135.  
  136.    <P>
  137. IRC  (original code was written by Jarkko Oikarinen)  is a multi-user,
  138. multi-channel  chatting  network.  It allows people all over the internet
  139. to  talk to one another in real-time.  It is a functional replacement and
  140. improvement to 'talk'; 'talk' is an old, primitive, atrocious, minimalist
  141. sort  of  keyboard/screen  conversation tool, using a grotesque, machine-
  142. dependent  protocol  (blah!).   IRC does everything 'talk' does, but with
  143. better  protocol, allowing more than 2 users to talk at once, with access
  144. across the aggregate Internet, and providing a whole raft of other useful
  145. features.
  146.  
  147.    <P>
  148. There  are two ways to enter IRC from a Unix system.  If you are using
  149. the   emacs    (editor  from  Richard  Stallman  and  the  Free  Software
  150. Foundation)   lisp  client,  you  just  have  to type "M-x irc", (if this
  151. doesn't  work  you  may need to load the client into your emacs session).
  152. If  you  are using the C client, (easier for beginners), then you usually
  153. type "irc".  Non-Unix boxes have special clients, each of which has to be
  154. configured using a special procedure. Check the manual or help screen for
  155. more information.
  156.  
  157.    <P>
  158. If  you  wish  to be known by a nickname which is not your login name,
  159. type  "irc  nickname"  instead.   Each  IRC  user,  ("client"), chooses a
  160. nickname.   All  communication with another user is either by nickname or
  161. by  the channel that they or you are on  (more information about channels
  162. later on).
  163.  
  164.    <P>
  165. The  most important thing to remember about IRC is that you have to be
  166. willing  to explore and learn to use it...  Take you time, try not to get
  167. flustered, enjoy  yourself,  and you will soon be making  new friends all
  168. over the world!
  169.  
  170.    <P>
  171. IRC  is  based  on  a  client-server model.  Clients are programs that
  172. connect  to  a  server,  a  server  is  a  program  that transports data,
  173. (messages),  from a user client to another.  There are clients running on
  174. many  different systems, (Unix, emacs, VMS, MSDOS, VM...), that allow you
  175. to  connect to an IRC server.  The client which will be spoken of here is
  176. the  most  widespread:   ircII, (originally designed by Michael Sandrof).
  177. Other clients are similar, and often accept ircII commands.
  178.  
  179. <HR>
  180.                         <CENTER><H3>1.2 How to behave on IRC</H3></CENTER>
  181. <HR>
  182.  
  183.    <P>
  184. The  most  widely  understood  and  spoken language on IRC is English.
  185. However,  as  IRC  is  used in many different countries, English is by no
  186. means  the  only language.  If you want to speak some other language than
  187. English,  (for  example  with your friends), go to a separate channel and
  188. set  the topic to indicate that.  On the other hand, you should check the
  189. topic  before you move  to a channel to see if there are any restrictions
  190. about  language.   On  a  non-restricted channel, please speak a language
  191. everybody can understand. If you want to do otherwise,change channels and
  192. set the topic accordingly.
  193.  
  194.    <P>
  195. It's  not  necessary  to  greet  everybody  on  a  channel personally.
  196. Usually  one "Hello!" or equivalent is enough. And don't expect everybody
  197. to  greet  you  back...   On a channel with 20 people that would mean one
  198. screenful of hellos.  It's sensible not to greet, in order not to be rude
  199. to  the rest of the channel.  If you must say hello to somebody you know,
  200. do it with a private message.  The same applies to goodbyes.
  201.  
  202.    <P>
  203. Also  note  that using your client facilities, (ircII "ON" command for
  204. instance),  to  automatically say hello or goodbye to people is extremely
  205. poor  etiquette.   Nobody wants to receive autogreets.  They are not only
  206. obviously  automatic,  but  even  if  you  think  you  are polite you are
  207. actually  sounding  insincere  and  also  interfering  with  the personal
  208. environment of the recipient when using autogreets.  If somebody wants to
  209. be autogreeted on joining a channel, he will autogreet himself.
  210.  
  211.   <P>
  212. Remember,  people  on  IRC  form  their opinions about you only by your
  213. actions,  writings  and  comments,  so think before you type.  If you use
  214. offensive  words,  you'll be frowned upon.  Do not "dump" to a channel or
  215. user,  (send  large  amounts of unwanted information).  This is likely to
  216. get  you  kicked  off the channel or killed off from IRC.  Dumping causes
  217. network "burps", connections going down because servers cannot handle the
  218. large amount of traffic anymore. Other prohibited actions include:
  219.  
  220. <UL>
  221. <LI>Harassing another user.  Harassment is defined as behavior towards another user with the purpose of annoying them.
  222. <LI>Annoying a channel with constant beeping.
  223. <LI>Any behavior reducing the functionality of IRC.
  224. </UL>
  225. <HR>
  226.                            <CENTER><H3>1.3 Privacy on IRC</H3></CENTER>
  227. <HR>
  228.  
  229.    <P>
  230. You  should always keep in mind that messages you send to someone over
  231. IRC are passed along  all the servers  between you and and the person you
  232. are writing to.  When you're sending a letter to someone,  any postman on
  233. the way could open it and read its contents...
  234.  
  235.    <P>
  236. Well,  it's  the same on the network.  Any IRC-Admin could compile its
  237. server  in "debug" mode and log whatever messages are transmitted through
  238. his  node,  (it  has  already  been done), so a good thumb rule is not to
  239. trust the servers.
  240.  
  241. <PRE>              +-------------------------------------------+
  242.               | IRC IS NOT A SECURE WAY OF COMMUNICATION! |
  243.               +-------------------------------------------+</PRE>
  244.  
  245.    <P>
  246. How  to  establish  direct  communications  between  clients  will  be
  247. explained later, (see DCC CHAT in section 2.5).  This should be used when
  248. you wouldn't want anybody else on IRC to intercept your private messages.
  249. <HR>
  250.  
  251.                             <CENTER><H3>1.4 First Steps</H3></CENTER>
  252. <HR>
  253.  
  254.    <P>
  255. Note:   ircII,  the  client  most  people  are using, has most of this
  256. information online.  If you are stuck, type "/HELP" and hit <return>.  To
  257. escape  from HELP mode, keep pressing <return> until your edit line, (the
  258. line  at the bottom of the screen), is empty.  Most of the information in
  259. this  file  can  be found typing these commands:  "/HELP INTRO" or "/HELP
  260. NEWUSER".
  261.  
  262. <PRE>           +------------------------------------------------+
  263.            | All ircII commands begin with a "/" character. |
  264.            +------------------------------------------------+</PRE>
  265.  
  266.    <P>
  267. The  slash  is  the  default command character.  Commands are not case
  268. sensitive,  and  can  be  abbreviated  to  their first letters: "/SI" and
  269. "/sign  <text>"  stand  for  /SIGNOFF and will both end your IRC session,
  270. (more in section 2.1).
  271.  
  272.    <P>
  273. Anything  that  does  not begin with "/" is assumed to be a message to
  274. someone  and will be sent to your current channel, or to a person you are
  275. QUERYing,  (the  QUERY  command  will  be  detailed  later on, maybe even
  276. section 2.2).
  277.  
  278.    <P>
  279. If  you  are not sure about the spelling of an ircII command, type the
  280. prefix  of  that command, and press the ESCape key twice; ircII will give
  281. you a listing of commands and aliases that start with that prefix.  Don't
  282. forget the "/" in front of the command though.
  283.  
  284.  <PRE>/W <ESC><ESC>
  285. *** Commands:
  286. ***     WAIT            WALL            WALLOPS       WHICH
  287. ***     WHILE           WHO             WHOIS         WHOWAS
  288. ***     WINDOW
  289. ***     Aliases:
  290. ***     W</PRE>
  291.  
  292.    <P>
  293. This  is  an  example.   Your  screen  may show more aliases, and less
  294. commands  than  shown  here, or less aliases and more commands - in other
  295. words "your mileage may vary"...
  296.  
  297. <HR>
  298.                     <CENTER><H3>1.5 Screen and Keyboard activity</H3></CENTER>
  299. <HR>
  300.  
  301.    <P>
  302. IRC is a full-screen utility.  It takes over the screen, with the bulk
  303. of  activity  happening  in  the top (N-2) lines, a status line, (vaguely
  304. emacs-like),  on  the  next to last line, and your input being entered on
  305. the  last  line.   When  typing  commands at ircII, you have a minimalist
  306. line-editing facility in an emacs style.
  307.  
  308.  
  309. <PRE>Table 1:  Editing keys
  310. ----------------------
  311. Key      Effects
  312. ~~~      ~~~~~~~
  313. ^P      recalls previous command line
  314. ^N      recalls next command line
  315. ^F      moves forward one character
  316. ^B      moves backward one character
  317. ^A      moves the cursor to the beginning of the line
  318. ^E      moves the cursor to the end of the line
  319. ^D      deletes the character under the cursor
  320. ^K      kills from the cursor to the end
  321. ^Y      reinserts the last stretch of killed text
  322. ^U      clears the whole line
  323. ^L      redraws the screen
  324.  
  325. Table 2:  Editing commands
  326. --------------------------
  327. Keyword   Action
  328. ~~~~~~~   ~~~~~~
  329. !         recalls previous commands for re-editing
  330. HISTORY   displays the command history
  331. LASTLOG   lists the most recent messages
  332. CLEAR     puts some white space on your screen</PRE>
  333.  
  334.  
  335.    <P>
  336. The  !   command  is  used to recall previous commands in your command
  337. history  for  re-execution.   The !  command is unique in that when it is
  338. used,  it  leaves  the  matching  history  entry  in  the  input line for
  339. re-editing.   You can specify a history entry either by its number in the
  340. history  list,  or  by  a  match  with  a given wildcard expression.  For
  341. instance,  "/!10"  will put  entry 10 in the history list  into the input
  342. line.  "/!/MSG" will search the history for a line beginning with a /MSG,
  343. (a "*" is implied at the end).
  344.  
  345. <PRE>/![(history number)|(history match)]
  346. Recalls previous commands for re-editing.
  347.  
  348. The command history can be dumped using:
  349.  
  350. /HISTORY [(number)]</PRE>
  351. <P>
  352. Displays  the  command  history  on  the  screen.  You can specify the
  353. number of history entries you wish to view as well.
  354.  
  355.  
  356.    <P>
  357. Almost  everything  happens  in  the  upper bulk  of the screen.  This
  358. includes  both  messages from other users,  as well as  the output of the
  359. control commands.  Normal  messages  from  other  users  appear  with the
  360. originating nickname in  <angle brackets>.  Private messages  arrive with
  361. the originating nickname  in  *asterisks*.  Messages you send to everyone
  362. appear with a preceding  "> "  whereas  messages  you  send  privately to
  363. another  user  appear  with  "-> *nickname*".  Other output  (invitations
  364. from other users  to join channels,  and so forth),  appears interspersed
  365. with other activity on the screen.
  366.  
  367.  
  368. <PRE>Table 3:  Simple screen activity
  369. --------------------------------
  370.  
  371. What is displayed    What you typed      Sender     Recipients
  372. ~~~~~~~~~~~~~~~~~    ~~~~~~~~~~~~~~      ~~~~~~     ~~~~~~~~~~
  373. > Morning people     Morning, people     You        Channel
  374. <some1else> hello                        some1else  Channel
  375. -> *some1else* hi!   /msg some1else hi!  You        some1else (only)
  376. *some1else* wassup?                      some1else  You (only)
  377.  
  378. Last ircII outputs can be recalled with:
  379.  
  380. /LASTLOG [<number of entries>|<text> [<from entry>]]</PRE>
  381. <P>
  382. Displays  the  contents  of  the  lastlog.  This is a list of the most
  383. recent  messages  that  have  appeared  on  the  screen,  useful  if  you
  384. inadvertantly  miss  messages.   If  no  arguments  are given, the entire
  385. lastlog  is  displayed.  If the first argument is a number, it determines
  386. how  many  log  entries  to  show.  Otherwise it is searched for in every
  387. lastlog  entry.   The  second  argument determines how many lines back to
  388. start display from.
  389.  
  390. <P>
  391. Example:
  392.  
  393. <PRE>/LASTLOG
  394. > Public message I send to all in the channel
  395. <some1else> Public message from some1else
  396. *some1else* Private message sent to me by some1else
  397. -> *some1else* Private message I send to some1else</PRE>
  398.  
  399. <P>
  400. Finally, if your screen gets garbage from a 'talk', 'write', 'wall' or
  401. any other form of primitive communication (smirk), hit ^L to redraw it,
  402. or CLEAR it.
  403.  
  404. <PRE>/CLEAR
  405. Clears the screen.</PRE>
  406.  
  407. <HR>
  408. <CENTER><H2>2. LET'S GO!</H2></CENTER>
  409. <HR>
  410. <CENTER><H3>2.1  General  Commands</H3></CENTER>
  411. <HR>
  412.  
  413. <PRE>Table 4:  General commands
  414. --------------------------
  415. Keyword   Action
  416. ~~~~~~~   ~~~~~~
  417. NICK      changes your nickname
  418. QUIT      exits your IRC session, (same as BYE, SIGNOFF and EXIT)
  419. HELP      prints help on the given command
  420. WHOIS     displays information about someone
  421. WHOWAS    displays information about someone who just left
  422. AWAY      leaves a message saying you're not paying attention
  423.  
  424. /NICK [<nickname>]
  425. Changes your nickname to whatever you like.</PRE>
  426.  
  427. <P>
  428. Everyone  who  wants  to  talk  to  you  sees this name - also, at the
  429. moment, nicknames are limited to 9 characters max.  Your nickname will be
  430. the  same as your login name by default.  You can also set an environment
  431. variable,  IRCNICK,  the  value  of which will be used instead.  Nickname
  432. clashes  are  not  allowed;  this  is  enforced  by the servers.  If your
  433. intended  nickname clashes with someone else's as you enter IRC, you will
  434. not be able to enter until you change it to something else.
  435.  
  436. <PRE>/NICK Nappy
  437. *** Nap is now known as Nappy
  438.  
  439. /QUIT [<reason>]
  440. Exits your IRC session.  You can also use BYE, SIGNOFF and EXIT.  If a
  441. reason is supplied, it is displayed to other people on your channels.
  442.  
  443. /QUIT Lunch Time!
  444. poly ~ >
  445.  
  446. /HELP [<command>]
  447. Shows help on the given command.
  448.  
  449. /HELP HELP
  450. Usage: HELP [command]
  451. Shows help on the given command. The help documentation is set
  452. up in a  hierarchical fashion.  That  means that  certain help
  453. topics have sub-topics under them.
  454. [boring stuff deleted]
  455.  
  456. /WHOIS [<nickname>]
  457. Shows information about someone.
  458.  
  459. /WHOIS Nap
  460. *** Nap is pioch@poly.polytechnique.fr (Klein bottle for sale... inquire within.)
  461. *** on channels: @#Twilight_Zone @#EU-Opers
  462. *** on via server poly.polytechnique.fr (Ecole Polytechnique, Paris, FRANCE ! )
  463. *** Nap has a connection to the twilight zone (is an IRC operator)
  464. *** Nap has been idle 0 seconds
  465.  
  466. /WHOIS Nappy
  467. *** Nappy: No such nickname</PRE>
  468.  
  469. <P>
  470. Sometimes WHOIS won't help you much, because the person you want to
  471. know more about just left IRC or changed nick.  However, you can use
  472. WHOWAS to get this information for a while:
  473.  
  474. <PRE>/WHOWAS [[<server>] <nickname>]
  475. Shows  information  about who used the given nickname last, even if no one is currently using it.
  476.  
  477. /WHOWAS Nappy
  478. *** Nappy was pioch@poly.polytechnique.fr (Artistic ventures highlighted. Rob a museum.) on channel *private*
  479. *** on irc via server poly.polytechnique.fr (Signoff: Mon Jun 22 20:15:23)</PRE>
  480.  
  481. <P>
  482. Very  often,  an  unsuccessfull call to WHOIS will lead you to try WHOWAS.
  483. That's  why  ircII  allows you to "/SET AUTO_WHOWAS ON"; that way, a "***
  484. <nickname>:   No  such  nickname"  message  will automagically generate a
  485. "/WHOWAS  <nickname>".   Try  typing  "/HELP  SET  AUTO_WHOWAS"  for more
  486. information on this topic.
  487.  
  488. <P>
  489. /AWAY [<away message>]
  490. <P>
  491. Leave a message explaining that you are not currently paying attention
  492. to  IRC.   Whenever  someone sends you a MSG or does a WHOIS on you, they
  493. automatically   see  whatever  message  you  set.   Using  AWAY  with  no
  494. parameters marks you as no longer being away.
  495.  
  496. <PRE>/AWAY Gone to get a cup of coffee.
  497. *** You have been marked as being away
  498.  
  499. /AWAY
  500. *** You are no longer marked as being away</PRE>
  501. <HR>
  502. <CENTER><H3>2.2  Communication and Private Conversation</H3></CENTER>
  503. <HR>
  504. <PRE>Table 5: Private conversation commands
  505. --------------------------------------
  506. Keyword  Action
  507. ~~~~~~~  ~~~~~~
  508. MSG      sends a private message
  509. QUERY    starts a private conversation
  510. NOTICE   sends a private message
  511. NOTIFY   warns you of people logging in or out IRC
  512. IGNORE   removes output from specific people off your screen</PRE>
  513.  
  514. <P>
  515. You can use the MSG command, (usually "M" is an alias for it), to send
  516. someone a message that only that person can read.
  517.  
  518. <PRE>/MSG <nickname>|<channel> <text>
  519. Send a private message to specified nickname.
  520.  
  521. /MSG Nap This message is for Nap only.
  522. -> *Nap* This message is for Nap only.
  523.  
  524. On my screen will appear:
  525.  
  526. *YourNick* This message is for Nap only.</PRE>
  527.  
  528. <P>
  529. If you want to send a private message to more than one person, you can
  530. specify a list of nicknames separated by commas, (no spaces).
  531.  
  532. <PRE>/MSG Nap,Sorg This message for both Nap and Sorg.
  533. -> *Nap* This message for both Nap and Sorg.
  534. -> *Sorg* This message for both Nap and Sorg.</PRE>
  535.  
  536. <P>
  537. Two  special  case  nicknames  are defined.  If the nickname is "," (a
  538. comma),  the  message  is sent to the last person who sent you a MSG.  If
  539. the nickname is "." (a period), the message is sent to the last person to
  540. whom you sent a message.
  541.  
  542. <P>
  543. You  can  have  a  private  conversation by only using /MSG.  However,
  544. typing  "/MSG <nick> <text>" or "/MSG .  <text>" gets cumbersome.  That's
  545. where the /QUERY command comes in handy.
  546.  
  547. <PRE>/QUERY [<nickname>|<channel>]
  548. Starts a private conversation with <nickname>.</PRE>
  549.  
  550. <P>
  551. All text you type that would normally be sent to your channel now goes
  552. to  the  supplied  nickname  in  the  form  of MSGs.  To cancel a private
  553. conversation, use QUERY with no arguments.
  554.  
  555. <PRE>/QUERY Nap
  556. *** Starting conversation with Nap
  557.  
  558. Blahblahblah
  559. -> *Nap* Blahblahblah
  560.  
  561. /QUERY
  562. *** Ending conversation with Nap</PRE>
  563.  
  564. <P>
  565. There is also another command to send messages, called NOTICE.  Unlike
  566. MSGs,  NOTICEs  are  surrounded  by  '-'  when  printed, and no automated
  567. responses, (such as generated by IGNORE or an automaton), will be sent in
  568. reply.  Services, (robots), on IRC often use this form of interaction.
  569.  
  570.  
  571. <PRE>/NOTICE <nickname>|<channel> <text>
  572. Sends a private message to the specified <nickname>.
  573.  
  574. /NOTICE Nap Better use /MSG instead of /NOTICE.
  575. -> -Nap- Better use /MSG instead of /NOTICE.
  576.  
  577. On my screen will appear:
  578.  
  579. -YourNick- Better use /MSG instead of /NOTICE.</PRE>
  580.  
  581. <P>
  582. As you begin to make new friends over IRC, you'll want to mark certain
  583. nicknames such that you will be warned when they signon or off.
  584.  
  585. <PRE>/NOTIFY [[-]<nickname>]</PRE>
  586.  
  587. <P>
  588. Adds or removes <nickname> to the list of people you'll be warned when
  589. they enter or quit IRC   (in ircII versions prior to 2.2, too many people
  590. in the NOTIFY list cause excessive slowness).
  591.  
  592. <PRE>/NOTIFY Nap Nappy
  593. *** Signon by Nap detected
  594.  
  595. /NOTIFY
  596. *** Currently present: Nap
  597. *** Currently absent: Nappy</PRE>
  598.  
  599. <P>
  600. Eventually,  you may wish some day not to see messages from a specific
  601. user  on  your  screen.   This  may  happen when someone is dumping large
  602. amounts  of garbage, or if someone is harassing you.  The proper response
  603. to  such a behavior is to  IGNORE that person.  IGNORE is a very powerful
  604. command,  and  can be used in many ways.  However the basic usage of this
  605. tool is the following.
  606.  
  607. <P>
  608. /IGNORE [<nickname>|<user@host> [[-]<message type>]]
  609.  
  610. <P>
  611. Suppresses  output from the given people from your screen.  IGNORE can
  612. be  set by nickname or by specifying a userid@hostname format.  Wildcards
  613. may  be  used  in all formats.  Output that can be ignored includes MSGs,
  614. NOTICEs,  PUBLIC messages, INVITEs, ALL or NONE.  Preceding a type with a
  615. "-" indicates removal of ignoring of that type of message.
  616.  
  617. <PRE>/IGNORE *@cheshire.oxy.edu ALL
  618. *** Ignoring ALL messages from *@CHESHIRE.OXY.EDU
  619.  
  620. /IGNORE
  621. *** Ignorance list:
  622. ***     *@CHESHIRE.OXY.EDU      ALL
  623.  
  624. /IGNORE *@cheshire.oxy.edu NONE
  625. *** *@cheshire.oxy.edu removed from ignorance list</PRE>
  626. <HR>
  627. <CENTER><H3>2.3  Channels and Public Conversations</H3></CENTER>
  628. <HR>
  629.  
  630. <P>
  631. On  IRC,  there  are  a  lot of places where you can "hang out"; those
  632. places  are  called  'channels', (most of the information in this section
  633. can  also  be  obtained  by  issuing  "/HELP  CHANNEL").  You can compare
  634. conversations  on  a  channel  to a conversation among a group of people:
  635. you  see/hear  everything  that  is  said,  and you can reply to anything
  636. that's  said.   What  you  type  is received by everyone who's willing to
  637. listen  -  and  everyone  who is late will not hear what was said before,
  638. unless  repeated  by  one  of  the  ones who were there.  (Who said "real
  639. life" ?)
  640.  
  641. <P>
  642. All  channels  on IRC have names:  a "#" sign followed by some kind of
  643. text-string,  like "#C++" or "#Asians" or "#EU-Opers".  Usually, the name
  644. of  the channel will indicate the type of conversation that's going on in
  645. there.  Don't count on it, though.
  646.  
  647. <PRE>Table 6:  Channel commands
  648. --------------------------
  649. Keyword   Action
  650. ~~~~~~~   ~~~~~~
  651. LIST      lists channels, number of users, topic
  652. NAMES     shows the nicknames of the users on each channel
  653. JOIN      sets your current channel, (same as CHANNEL)
  654. WHO       gives a listing of users
  655. INVITE    sends an invitation to another user
  656. LEAVE     leaves a channel, (same as PART)
  657. KICK      gets rid of someone on a channel
  658. TOPIC     changes the topic of the channel
  659. ME        sends anything about you to a channel or QUERY
  660. DESCRIBE  sends anything about you to a person or channel</PRE>
  661.  
  662. <P>
  663. Every channel has certain characteristics, called channel modes.
  664. These will also be explained below.  Recall the NAMES and LIST
  665. commands; they will show you the names of the existing channels.
  666.  
  667. <P>
  668. /LIST [[<flags>] <channel mask>]
  669.  
  670. <P>
  671. Lists  all  current  "channels",  number  of  users,  and  topic.   The
  672. displayed  list  may  be  quite  long,  so  you can limit it using flags.
  673. "/LIST  -MIN n" for instance removes channels with less than 'n' users of
  674. the output.
  675.  
  676. <PRE>Example:
  677.  
  678. /LIST -MIN 5
  679. *** #aussies   5
  680. *** #amiga     5        Daily Amiga Silence...join&enjoy
  681. *** #hottub    21       Imagine sky, high above...
  682. *** #tuebingen 11       Happy Borthday CHUCK!!!
  683. *** #Christian 6        Jesus!
  684. *** #Twilight_ 15       The Oper Bar & Grill
  685. *** #initgame  5        More players needed!!!!!!!!!!!!
  686. *** #Taiwan    8        Welcome good friends.
  687. *** #espanol   6        EMERGENCIA SE Necesitan Mujeres!
  688. *** #sherwood  7
  689. *** #francais  6        on apprend le japonais (japanese welcome)
  690.  
  691. /NAMES [[<flags>] <channel mask>]</PRE>
  692.  
  693. <P>
  694. Shows the nicknames of all users on each "channel", (these may be very
  695. long.  Remember to filter them with "-MIN n" or "-MAX n").
  696.  
  697. <PRE>/NAMES -MIN 5
  698. Pub: #twilight> Mycroft @sojge scorpio @Troy @Avalon @Nap phone
  699. Merlinus Lumberjak @tzoper
  700. Pub: #espanol   Cacique Bonjovi leopardo Carina Miguel Cisco r2
  701. Pub: #amiga     @gio @Radix @xterm @mama @AmiBot
  702. Pub: #aussies   @Bleve @GrayElf @Insomniac @Morkeleb @titus
  703. Pub: #hottub    baby @Aldur KnightOrc @Toasty Gwydion @Belkira
  704. @Aiken Edge @Spockobot @Nada @ZBot @Aurik @anna @RedBaron
  705. @Katzen @esashi IceWolf @Eniigma @Digger @TheHeck
  706.  
  707. To  join in the conversation on a certain channel you may use the JOIN
  708. command.
  709.  
  710. /JOIN [<channel>]
  711. Sets your current channel to the supplied channel.
  712.  
  713. /JOIN #Twilight_Zone
  714. *** Nap has joined channel #Twilight_Zone
  715. *** Topic: The Gernsback Continuum
  716. *** Users on #Twilight_Zone: Nap msa tober phone @julia @SirLance
  717. igh @Daemon @Avalon @Waftam @Trillian @tzoper</PRE>
  718.  
  719. <P>
  720. The CHANNEL command has the same effects. Note that if no parameters
  721. are given, your current channel is displayed.
  722.  
  723. <P>
  724. Upon  entering a channel, you are given useful details about it:  list
  725. of  users  talking  in that channel, topic...  Joining a channel does not
  726. cause you to leave your previous channel unless NOVICE is set to ON.  See
  727. "/HELP SET NOVICE".
  728.  
  729. <P>
  730. Once  in  a  channel, you may wish to get a detailed list of the people
  731. IRCing inside.  That's where the WHO command comes in handy:
  732.  
  733. <PRE>/WHO [<channel>|<wildcard expression>]</PRE>
  734.  
  735. <P>
  736. Gives  a  listing  of  users.   "/WHO *" for the list of users in your
  737. current channel.
  738.  
  739. <PRE>/WHO #Twilight_Zone
  740. Channel    Nickname     S    User@Host (Name)
  741. #Twilight_ Nap          H*   pioch@poly.polytechnique.fr
  742. (Quidquid latine dictum sit, altum viditur)
  743. #Twilight_ msa          H    msa@tel1.tel.vtt.fi (Markku Savela)
  744. #Twilight_ tober        H    ircuser@kragar.eff.org (tober)
  745. #Twilight_ phone        H    mrgreen@munagin.ee.mu.OZ.AU (Third
  746. row seats to the Cure? WHO ME? nah.. *grin*)
  747. #Twilight_ julia        G*@  julie@turing.acs.Virginia.EDU
  748. ( Future graduate of ACME Looniversity)
  749. #Twilight_ SirLance     G*@  lancelot@tdsb-s.mais.hydro.qc.ca
  750. (Sir Lancelot)
  751. #Twilight_ igh          G    igh@micom1.servers.unsw.EDU.AU (igh)
  752. #Twilight_ Daemon       G*@  frechett@spot.Colorado.EDU
  753. (-=Runaway Daemon=-)
  754. #Twilight_ Avalon       H*@  avalon@coombs.anu.edu.au (Avalon...)
  755. #Twilight_ Waftam       G*@  danielce@munagin.ee.mu.OZ.AU (Daniel
  756. Carosone)
  757. #Twilight_ Trillian     G*@  hrose@rocza.eff.org ( I turn to
  758. stone when you are gone )
  759. #Twilight_ tzoper       H*@  tzoper@azure.acsu.buffalo.edu (/msg
  760. tzoper help)</PRE>
  761.  
  762. <P>
  763. The  first  field  is the current channel, then nickname, status, real
  764. name  (in internet user@host form), and a small witty comment you can set
  765. yourself with the environment variable IRCNAME, (this will be detailed in
  766. section  2.8).   Status  indicates  if  a  user is "H"ere or "G"one, (see
  767. AWAY), if IRCop ("*"), and/or chanop ("@").
  768.  
  769. <P>
  770. It is also possible, when you are already on a channel, to ask someone
  771. to join your channel.  The command is called INVITE.
  772.  
  773. <PRE>/INVITE <nickname> [<channel>]</PRE>
  774.  
  775. <P>
  776. Invites  another  user to a channel.  If no channel is specified, your
  777. current channel is used.
  778.  
  779. <PRE>/INVITE Nap
  780. *** Inviting Nap to channel #Twilight_Zone</PRE>
  781.  
  782. <P>
  783. If you receive an INVITE message, you can type "/JOIN -INVITE" to join
  784. the channel to which you were last invited, or simply "/JOIN <channel>".
  785.  
  786. <P>
  787. To  leave  a  channel,  just issue a LEAVE command, (PART has the same
  788. effects):
  789.  
  790. <PRE>/LEAVE <channel>
  791. Leave a channel.
  792.  
  793. /LEAVE #Twilight_Zone
  794. *** Nap has left #Twilight_Zone</PRE>
  795.  
  796. <P>
  797. Well,  you  guessed  it,  if  there  is  a  way to invite someone on a
  798. channel,  there's  also  the  possibility  to KICK someone out of it, for
  799. example  if  this  person  is  behaving  like  a jerk, annoying people or
  800. flooding the channel with unwanted information:
  801.  
  802. <PRE>/KICK [<channel>] <nickname></PRE>
  803.  
  804. <P>
  805. Kicks  named  user  off a given channel.  Only 'channel operators' are
  806. privileged to use this command.
  807.  
  808. <PRE>/KICK #Twilight_Zone Target
  809. *** Target has been kicked off channel #Twilight_Zone by Nap</PRE>
  810.  
  811. <P>
  812. Channels have topics, that indicate the current topic of conversation.
  813. You can change this topic on a channel with the TOPIC command.
  814.  
  815. <PRE>/TOPIC [[<channel>] <topic for channel>]
  816. Changes the topic for the channel.
  817.  
  818. /TOPIC The silent channel.
  819. *** Nap has changed the topic on channel #EU-Opers to The silent channel.</PRE>
  820.  
  821. <P>
  822. At  times, you may want to send a description of what you are doing or
  823. how  you  are  feeling  or  just anything  concerning you  to the current
  824. channel  or  query.  It is absolutely good style to not forget the period
  825. at the end of the sentence!
  826.  
  827. <PRE>/ME <action description>
  828. Tells the current channel or query about what you are doing.
  829.  
  830. /ME opens up the fridge.
  831. * Nap opens up the fridge.
  832.  
  833. You can also use your own nickname as command, i.e. you can type
  834.         
  835. /Nap reaches out for the orange juice.
  836. * Nap reaches out for the orange juice.
  837.  
  838. The same goal can be achieved towards a specific nickname using:
  839.  
  840. /DESCRIBE <nickname>|<channel> <action description></PRE>
  841.  
  842. <P>
  843. Sends anything concerning you to the <nickname> or <channel> you pass
  844. as first argument.
  845.  
  846.  
  847. <P>
  848. (Note:  The look of the result depends on each client version, and might not be exactly the same as in the examples shown here.)
  849.  
  850. <P>
  851. These  commands  make use of CTCP, a client-to-client protocol crafted
  852. to  perform  specific actions,  but  not understood by all clients, (more
  853. about  CTCP  in  section  2.5).   If  you  get  an  error  message,  your
  854. description may not have arrived properly.
  855.  
  856. <HR>
  857. <CENTER><H3>2.4  Channel and User Modes</H3></CENTER>
  858. <HR>
  859.  
  860. <P>
  861. Channels can have additional constraints, which can be set by the MODE
  862. command, (most of the information in this section can also be obtained by
  863. issuing  "/HELP MODE").  To understand this, recall that the first person
  864. to JOIN a channel effectively creates it  and is initially "in charge" of
  865. the  channel,  ("Channel Operator" or "chanop").  He/She can subsequently
  866. add those constraints, make other people chanops at leisure.
  867.  
  868. <PRE>Table 7:  Mode commands
  869. -----------------------
  870. Keyword  Action
  871. ~~~~~~~  ~~~~~~
  872. MODE     changes channel or user mode</PRE>
  873.  
  874. <P>
  875. Public is the default mode for a channel.  When someone is on a public
  876. channel, he can be seen by all other users, (if his own user mode permits
  877. this).   Anyone  can  notice  users  on  a public channel and join such a
  878. conversation.
  879.  
  880. <P>
  881. Private means that, although anyone can see members of such a channel,
  882. you  can't  tell  what channel they are on unless you are already on that
  883. channel  with  them.   They  just  appear  as "Prv:  *" in LIST or NAMES.
  884. Since  the number of potential channels is in the billions, this is quite
  885. some  security  -  all  you  give away is the acknowledgement that you're
  886. IRCing.
  887.  
  888. <P>
  889. If you are on a secret channel, someone who is not on the same channel
  890. can't  even see that you are there.  Your name does not show up in a LIST
  891. of  active  users.   The  only  indication of your presence is that, when
  892. entering  IRC,  all new users are told that there are "NNNNN users on XXX
  893. servers".   If someone  checks  on all users and finds less than NNNNN of
  894. them,  he  knows  that other people are hiding on secret channels.  But a
  895. secret  channel user still cannot be found except by brute-force checking
  896. through  all  channels,  a  hopeless  proposition in the face of the huge
  897. number  of  possible  channel  names.  Security through obscurity finally
  898. means something.
  899.  
  900. <PRE>/MODE <channel>|<nickname> [[+|-]<modechars> [<parameters>]]</PRE>
  901.  
  902. <P>
  903. Allows channel operators to change channel mode, or any user to change
  904. their personal mode, (don't use this command too often, it floods the net
  905. with worthless information).
  906.  
  907. <PRE>/MODE #Twilight_Zone +m
  908. *** Mode change "+m" on channel #Twilight_Zone by Nap
  909.  
  910. /MODE Nap -i
  911. *** Mode change "-i" for user Nap by poly.polytechnique.fr
  912.  
  913. And this is how to give 'chanop' status to someone on the channel
  914.  
  915. /MODE #Twilight_Zone +o sojge
  916. *** Mode change "+o sojge" on channel #Twilight_Zone by Nap</PRE>
  917.  
  918. <P>
  919. A + or - sign  determines whether the mode should be added or deleted.
  920. Try typing  "/HELP MODE"  to  get  further  information.  Channels can be
  921. moderated (only chanops can talk), secret, private, with a limited number
  922. of users, anonymous,  invite-only,  topic-limited,  with a list of banned
  923. users...
  924.  
  925. <P>
  926. The  MODE  command also allows you to modify your personal parameters,
  927. your  "user  mode".   You can check your usermode with the command "/MODE
  928. <YourNick>"  or  sometimes  "/UMODE".   Note that user mode +i may be the
  929. default  on  some  servers,  in  order to protect privacy of users.  This
  930. should  not  be  seen  as  a  problem,  since any user can change his/her
  931. personal mode whatever defaults a server may set.
  932.  
  933.  
  934. <PRE>Table 8:  Channel modes
  935. -----------------------
  936. ModeChar        Effects on channels
  937. ~~~~~~~~        ~~~~~~~~~~~~~~~~~~~
  938. b <name>       ban somebody, in "nick!user@host" form
  939. i               channel is invite-only
  940. l <number>      channel is limited, <number> users allowed max
  941. m               channel is moderated, (only chanops can talk)
  942. n               external /MSGs to channel are not allowed
  943. o <nick>        makes <nick> a channel operator
  944. p               channel is private
  945. s               channel is secret
  946. t               topic limited, only chanops may change it
  947.  
  948. Table 9:  User modes
  949. --------------------
  950. ModeChar        Effects on nicknames
  951. ~~~~~~~~        ~~~~~~~~~~~~~~~~~~~~
  952. i               makes yourself invisible to anybody that does
  953.                         not know the exact spelling of your nickname
  954. o               IRC-operator status, can only be set
  955.                         by IRC-ops with OPER
  956. s               receive server notices
  957. w               receive wallops (abused and deprecated)</PRE>
  958. <HR>
  959. <CENTER><H3>2.5  Client to Client Protocol</H3></CENTER>
  960. <HR>
  961.  
  962. <PRE>/CTCP <nickname> <command> [<argument>]
  963. Allows you to perform certain client specific actions on the network.
  964.  
  965. /CTCP Nap VERSION
  966. *** CTCP VERSION reply from Nap: ircII 2.2 *IX
  967. :ircII 2.2, SL0 The one you thought you'd never see.
  968.  
  969. This can be used to get information about how long a person has been idle:
  970.  
  971. /CTCP Nap FINGER
  972. *** CTCP FINGER reply from Nap: PIOCH Nicolas - Nap on IRC, X90,
  973. (pioch@poly.polytechnique.fr) Idle 0 seconds
  974.  
  975. Table 10:  Client to Client Commands
  976. ------------------------------------
  977. Keyword    Action
  978. ~~~~~~~    ~~~~~~
  979. CTCP       performs certain client specific actions
  980. DCC        handles direct connections to remote clients
  981. DCC SEND   initiates a file transfer
  982. DCC GET    accepts a file transfer
  983. DCC CLOSE  ends a DCC connection or offer
  984. DCC LIST   shows current DCC connections
  985. DCC CHAT   initiates a secure chat between two clients</PRE>
  986.  
  987. <P>
  988. There  are  many  other CTCP commands, and new ones are introduced all
  989. the  time.   There  is  a mechanism for you to find out what you can use:
  990. CTCP  CLIENTINFO.   To find out about your own client services, execute a
  991. CLIENTINFO on yourself.
  992.  
  993. <PRE>/CTCP Nap CLIENTINFO
  994. *** CTCP CLIENTINFO reply from Nap: SED VERSION CLIENTINFO
  995. USERINFO ERRMSG FINGER TIME ACTION DCC UTC PING :Use
  996. CLIENTINFO <COMMAND> to get more specific information</PRE>
  997.  
  998. <P>
  999. If  you are interested in this powerful CTCP mechanism, have a look in
  1000. the  various  ircII  help  files.   "/HELP  CTCP"  might tell you more...
  1001. However  the  client-to-client  protocol  has  a  very  powerful feature:
  1002. Allowing two people to exchange files.
  1003.  
  1004. <P>
  1005. To  send  small  text  files,  electronic  mail  is  probably the best
  1006. solution, (don't rely on the user@host given by the WHOIS command to send
  1007. mail.     For    people   registered   on   NickServ,   you   can   "/MSG
  1008. NickServ@Service.de  WHOIS  nick" to get their E-mail address).  However,
  1009. ircII  provides  you a way to establish Direct Client Connections ("DCC")
  1010. to perform functions like sending and receiving files.
  1011.  
  1012. <PRE>If NickA wants to send a file to NickB, then NickA should type:
  1013. /DCC SEND NickB filename
  1014.  
  1015. On NickB's screen will appear:
  1016. *** DCC SEND (filename) request received from NickA
  1017.  
  1018. If he, (NickB), wants to get the file, he just needs to type:
  1019. /DCC GET NickA filename
  1020.  
  1021. A few seconds later
  1022. *** DCC GET connection with NickA established
  1023. *** DCC GET filename connection to NickA completed
  1024. will   inform  both  users  that  data  transfer  has  been  successfully
  1025. completed.
  1026.  
  1027. Here's a quick overview of the subject:
  1028.  
  1029. /DCC <function> [<arguments>]
  1030. Handles direct connections to remote clients.  The behavior of  DCC is
  1031. determined by the specified <function>.
  1032.  
  1033. /DCC SEND <nickname> <filename>
  1034. Initiates a file transfer by direct client connection.
  1035.  
  1036. /DCC GET <nickname> <filename>
  1037. Accepts  a file transfer by direct client connection.  The sender must
  1038. first have offered the file with DCC SEND.
  1039.  
  1040. /DCC CLOSE <type> <nickname> [<arguments>]</PRE>
  1041.  
  1042. <P>
  1043. Ends  an unwanted DCC connection or offer.  The <type>, <nickname> and
  1044. <arguments>  must  be  the  same  as  those shown by "/DCC LIST".  If the
  1045. arguments  are  not supplied, the oldest connection of the specified type
  1046. is closed.
  1047.  
  1048. <PRE>/DCC LIST
  1049.  
  1050. Shows  current /DCC connections with their types, status and nicknames
  1051. involved.
  1052.  
  1053. More  details  can  be found in ircII online help:  try "/HELP DCC"...
  1054. for more information.</PRE>
  1055.  
  1056. <P>
  1057. However,  if  someone  asks you to send him a file, DON'T do it unless
  1058. you  EXACTLY  know  what  you  are  doing.  For instance,  NEVER send the
  1059. password  file  of  your  system  to  anybody.  This could grant crackers
  1060. illegal   access   to   your  machines,  and  put  you  and  your  system
  1061. administrator in much trouble.
  1062.  
  1063. <P>
  1064. DCC  also  allows two clients to establish a direct client connection for
  1065. chat.   This  is  a  secure form of communication, since messages are not
  1066. sent through the IRC network.
  1067.  
  1068. <PRE>/DCC CHAT</PRE>
  1069.  
  1070. <P>
  1071. Initiates  a direct client connection chat to the given nick, who must
  1072. repond  with  DCC  CHAT.   Once  established, messages are sent over with
  1073. "/MSG =Nickname ...".
  1074.  
  1075. <HR>
  1076. <CENTER><H3>2.6  Network Related Commands</H3></CENTER>
  1077. <HR>
  1078.  
  1079. <P>
  1080. If  you encounter any problem, contact your local IRC-Administrator or
  1081. an  IRC-Operator.   An  IRC-Admin is a person who has access to all files
  1082. concerning 'ircd' (the server program).  An IRC-Operator or "IRC-op" is a
  1083. person  who  has  privileges  given  to  him by an IRC-Admin and tries to
  1084. maintain  a  fast  reliable IRC network.  Information on how you can find
  1085. out who he/she is, can be found below.
  1086.  
  1087. <P>
  1088. Each  time  you are prompted for a server name, remember you can supply
  1089. the nickname of someone being connected on that server instead.  This may
  1090. be useful at times...
  1091.  
  1092. <PRE>Table 11:  Network related commands
  1093. -----------------------------------
  1094. Keyword  Action
  1095. ~~~~~~~  ~~~~~~
  1096. ADMIN    displays information about a server
  1097. LINKS    shows the servers on the IRC network
  1098. SERVER   switches your primary server
  1099. MOTD     displays the server message-of-the-day
  1100. USERS    prints users logged on the server machine
  1101. DATE     shows server current date and time
  1102. TIME     shows server current date and time
  1103. LUSERS   gives a brief listing of users, servers and operators
  1104. TRACE    shows the server connections of the given server
  1105. STATS    shows some irc server usage statistics
  1106. INFO     shows useless information about IRC
  1107. VERSION  shows client and server version number
  1108.  
  1109. /ADMIN [<server>]</PRE>
  1110.  
  1111. <P>
  1112. Displays  the  administrative  details  about the given server.  If no
  1113. server is supplied, the server you are connected to is used.
  1114.  
  1115. <PRE>/ADMIN
  1116. ### Administrative info about poly.polytechnique.fr
  1117. ### Ecole Polytechnique, Palaiseau, FRANCE
  1118. ### IRC-Administrator Nicolas Pioch (Nap@IRC)
  1119. ### <pioch@poly.polytechnique.fr>
  1120.  
  1121. /LINKS [[<server>] <wildcard expression>]</PRE>
  1122.  
  1123. <P>
  1124. Shows  a  list  of servers currently connected to the IRC network.  If
  1125. <wildcard expression> is given, /LINKS asks the given <server> for a list
  1126. of servers matching the given expression, (this list can get very long!).
  1127.  
  1128. <PRE>/LINKS *po*
  1129. *** nova.unix.portal.com  7 Cupertino California, USA
  1130. *** poe.acc.Virginia.EDU  6 University of Virginia 2.7.1f
  1131. *** polaris.utu.fi        9 University of Turku, Finland
  1132. *** polaris.ctr.columbia.edu 6 Columbia University, New York City
  1133. *** csd.postech.ac.kr     4 POSTECH Computer Science Dept.
  1134. *** cdc853.cdc.polimi.it  2 Polytechnic of Milan, Italy
  1135. *** poly.polytechnique.fr 0 Ecole Polytechnique, Paris, FRANCE
  1136.  
  1137. /SERVER [<server>|<server number> [<port number>]]</PRE>
  1138.  
  1139. <P>
  1140. Switches your primary server to the supplied <server> at the specified
  1141. <port  number>.   If  no port number is given, the default port number is
  1142. used (normally 6667).
  1143.  
  1144. <PRE>/SERVER poly.polytechnique.fr 6667
  1145. *** Connecting to port 6667 of server poly.polytechnique.fr
  1146. *** Welcome to the Internet Relay Network, Nap
  1147. *** Your host is poly.polytechnique.fr, running version 2.7.2g.ID
  1148. *** This server was created Sat Jan 16 1993 at 12:16:10 MET</PRE>
  1149.  
  1150. <P>
  1151. Occasionally,  you  can switch servers faster than the IRC network can
  1152. send  out  the  information  that you have left your previous server.  So
  1153. don't  be  surprised  if  you are told your nickname is already in use...
  1154. Just wait a moment and set it with /NICK again.
  1155.  
  1156. <PRE>/MOTD [<server>]</PRE>
  1157. <P>
  1158. Gives the  Message-Of-The-Day for the named server. If no server is
  1159. given, your server is used.
  1160.  
  1161. <PRE>/MOTD
  1162. MOTD - poly.polytechnique.fr message of the day -
  1163. MOTD -   _____________________________________
  1164. MOTD -  /¥                                    ¥
  1165. MOTD -  ¥_|      Bienvenue sur le serveur      |
  1166. MOTD -    |         Internet Relay Chat        |
  1167. MOTD -    |  de l'Ecole Polytechnique, FRANCE  |
  1168. MOTD -    |   _________________________________|__
  1169. MOTD -     ¥_/___________________________________/
  1170. MOTD -
  1171. MOTD -        |    |    |      En cas de probleme,
  1172. MOTD -       )_)  )_)  )_)           tapez / admin
  1173. MOTD -      )___))___))___)¥
  1174. MOTD -     )____)____)_____)¥¥       Nicolas PIOCH
  1175. MOTD -   _____|____|____|____¥¥¥__     Nap sur IRC
  1176. MOTD - --¥  Welcome on IRC !  /---------
  1177. MOTD -   ^^^^^^^^^^^^^^^^^^^^^ ^^^ ^^^
  1178. * End of /MOTD command
  1179.  
  1180. /USERS [<server>]</PRE>
  1181.  
  1182. <P>
  1183. Shows the users logged into the machine where the server is running,
  1184. (it's up to the server administrator to implement this feature or not.
  1185. It may not work on some machines).
  1186.  
  1187. <PRE>/USERS
  1188. *** UserID  Terminal    Host
  1189. *** pioch   ttyp9       rotule.polytechn
  1190. *** pioch   ttypc       rotule.polytechn
  1191. *** pioch   ttyq0       rotule.polytechn
  1192. *** pioch   ttyq1       rotule.polytechn
  1193.  
  1194. /DATE [<server>]
  1195. /TIME [<server>]</PRE>
  1196.  
  1197. <P>
  1198. Shows the current time of day and date.  If a server is specified, the
  1199. time  of  day  and date are reported from that server.  DATE and TIME are
  1200. identical.
  1201.  
  1202. <PRE>/DATE
  1203. *** poly.polytechnique.fr Saturday June 20 1992 -- 02: 35 +01:00
  1204.  
  1205. /LUSERS</PRE>
  1206.  
  1207. <P>
  1208. Gives  a  brief  listing of the number of servers, operators and users
  1209. matching  the  given  <wildcard  expression>,  as seen from the specified
  1210. <server>.
  1211.  
  1212. <PRE>/LUSERS
  1213. *** There are 1008 users and 291 invisible on 135 servers
  1214. *** 72 users have connection to the twilight zone
  1215. *** There are 458 channels
  1216. *** I have 16 clients and 4 servers
  1217. *** 22 maximum connections, 19 clients
  1218.  
  1219. /TRACE [<server>]
  1220.  
  1221. Shows the server connections of the given <server>.
  1222.  
  1223. /TRACE
  1224. *** Serv Class[9] ==> 134S 1331C eff.org[192.88.144.3]
  1225. *** Serv Class[8] ==> 1S 6C Julia.Enst.FR
  1226. *** Serv Class[8] ==> 1S 6C Eurecom8.Cica.FR[192.70.34.208]
  1227. *** Serv Class[1] ==> 2S 0C athina.cc.uch.gr[147.52.80.102]
  1228. *** Serv Class[8] ==> 1S 5C dafne.mines.u-nancy.fr[192.70.66.2]
  1229. *** Serv Class[8] ==> 1S 0C cnam.cnam.fr
  1230. *** Class 0 Entries linked: 16
  1231. *** Class 9 Entries linked: 1
  1232. *** Class 8 Entries linked: 4
  1233. *** Class 1 Entries linked: 1
  1234.  
  1235. /STATS c|i|k|l|m|u|y [<server>]
  1236.  
  1237. Shows some irc server usage statistics.
  1238.  
  1239. /STATS u
  1240. *** Server Up 12 days, 12:28:44
  1241.  
  1242. /INFO [<server>]</PRE>
  1243.  
  1244. <P>
  1245. Shows  information about the IRC creators, debuggers, slaves and a lot
  1246. of other people who no longer have much to do with IRC.
  1247.  
  1248. <PRE>/VERSION
  1249.  
  1250. Shows the ircII version number and the version number of the server.
  1251.  
  1252. <PRE>/VERSION
  1253. *** Client: ircII 2.2
  1254. *** Server poly.polytechnique.fr: ircd 2.7.2g.Nap+6(privacy).</PRE>
  1255.  
  1256. <HR>
  1257. <CENTER><H3>2.7 Quick Reference Panel</H3></CENTER>
  1258. <HR>
  1259.  
  1260. <UL>
  1261. <PRE><LI>       !            recalls previous commands for re-editing
  1262. <LI>       ADMIN        displays information about a server
  1263. <LI>       AWAY         leaves a message saying you're not paying attention
  1264. <LI>       CLEAR        puts some white space on your screen
  1265. <LI>       CTCP         performs certain client specific actions
  1266.  
  1267. <LI>       DATE         shows server current date and time
  1268. <LI>       DCC          handles direct connections to remote clients
  1269. <LI>       DESCRIBE     sends anything about you to a person or channel
  1270. <LI>       HELP         prints help on the given command
  1271. <LI>       HISTORY      displays the command history
  1272.  
  1273. <LI>       IGNORE       removes output from specific people off your screen
  1274. <LI>       INFO         shows useless information about IRC
  1275. <LI>       INVITE       sends an invitation to another user
  1276. <LI>       JOIN         sets your current channel
  1277. <LI>       KICK         gets rid of someone on a channel
  1278.  
  1279. <LI>       LASTLOG      lists the most recent messages
  1280. <LI>       LEAVE        leaves a channel
  1281. <LI>       LINKS        shows servers on the IRC network
  1282. <LI>       LIST         lists channels, number of users, topic
  1283. <LI>       LUSERS       gives a brief listing of users, servers and operators
  1284.  
  1285. <LI>       ME           sends anything about you to a channel or QUERY
  1286. <LI>       MODE         changes channel mode
  1287. <LI>       MOTD         displays the server message-of-the-day
  1288. <LI>       MSG          sends a private message
  1289. <LI>       NAMES        shows the nicknames of users on each channel
  1290.  
  1291. <LI>       NICK         changes your nickname
  1292. <LI>       NOTICE       sends a private message
  1293. <LI>       NOTIFY       warns you of people logging in or out IRC
  1294. <LI>       QUERY        starts a private conversation
  1295. <LI>       QUIT         exits your IRC session
  1296.  
  1297. <LI>       SERVER       switches your primary server
  1298. <LI>       STATS        shows some irc server usage statistics
  1299. <LI>       TIME         shows server current date and time
  1300. <LI>       TOPIC        changes the topic of the channel
  1301.  
  1302. <LI>       TRACE        shows the server connections of the given machine
  1303. <LI>       USERS        prints users logged on the server machine
  1304. <LI>       VERSION      shows client and server version number
  1305. <LI>       WHO          gives a listing of users
  1306. <LI>       WHOIS        displays information about someone
  1307.  
  1308. <LI>       WHOWAS       displays information about someone who just left</PRE>
  1309. </UL>
  1310. <HR>
  1311. <CENTER><H3>2.8 Further into ircII Wizardry</H3></CENTER>
  1312. <HR>
  1313.  
  1314. <P>
  1315. <B>Note: This part should be reserved for experienced IRC'ers.</B>
  1316.  
  1317. <P>
  1318. Because ircII is not a simple client program, but an Operating System,
  1319. its  programming  language  is  just  as simple as you could expect (it's
  1320. horrendous),  but  if  you  want to get into it, here's a little note for
  1321. you...
  1322.  
  1323. <P>
  1324. There  are  a few Unix environment variables you can set in your shell
  1325. configuration file, but you need to find out your shell name before that.
  1326. "echo $SHELL" should give you a hint.
  1327.  
  1328. <PRE>Table 12:  Setting environment variables
  1329. ----------------------------------------
  1330. Shell type      Shell name      Command
  1331. ~~~~~~~~~~      ~~~~~~~~~~      ~~~~~~~
  1332. Bourne shells   sh              $ VARNAME="value" ; export VARNAME
  1333.                 ksh             $ export VARNAME="value"
  1334.                 bash            $ export VARNAME="value"
  1335. C-shells        csh             % setenv VARNAME "value"
  1336.                 tcsh            > setenv VARNAME "value"
  1337.  
  1338. Table 13:  Environment variables
  1339. --------------------------------
  1340. Name            Effects
  1341. ~~~~            ~~~~~~~
  1342. HOME            where your home directory is
  1343. IRCNAME         any lunacy you want instead of your real name
  1344.                 (text that appears between parentheses in a WHOIS)
  1345. IRCNICK         your default IRC nickname
  1346. IRCPATH         a directory path to LOAD scripts
  1347. IRCRC           a file to use instead of your $HOME/.ircrc
  1348. IRCSERVER       a default server list for ircII
  1349. TERM            your terminal type</PRE>
  1350.  
  1351. <P>
  1352. The command character, (usually "/"), is only necessary when you type
  1353. commands interactively, when you program things it is no more needed, it
  1354. used to be though.
  1355.  
  1356. <PRE>Table 14: Advanced commands
  1357. ---------------------------
  1358. Keyword         Action
  1359. ~~~~~~~         ~~~~~~
  1360. #               same as COMMENT except for the lenght
  1361. @               performs variable expressions
  1362. ALIAS           creates command aliases
  1363. ASSIGN          creates user variables (expandable with $)
  1364. BIND            binds a keystroke sequence to a function
  1365.  
  1366. CD              changes ircII working directory
  1367. COMMENT         does nothing, but very useful. Strange, uh?
  1368. ECHO            displays all of its arguments
  1369. EXEC            allows you to start subprocesses
  1370. FLUSH           flushes all pending output from the server
  1371.  
  1372. IF              standard boolean expression checker
  1373. LOAD            loads an ircII command script file
  1374. ON              sets up actions to occur when certain events happen
  1375. REDIRECT        forwards the output from a command
  1376. SAVE            saves all ircII settings into a file
  1377.  
  1378. SAY             same as sending text to a channel
  1379. SEND            same as sending text to a channel
  1380. SET             sets a variable to a given value
  1381. SLEEP           suspends ircII for a few seconds
  1382. TYPE            simulates keystrokes
  1383.  
  1384. WAIT            waits for all server output to finish
  1385. WHILE           another control command to make loops
  1386. WINDOW          lets you manipulate multiple "windows" in ircII
  1387. XECHO           like ECHO, but takes flag arguments</PRE>
  1388.  
  1389. <P>
  1390. If you want to type to the channel from within an ALIAS or on BINDing,
  1391. you have to use SAY or SEND.
  1392.  
  1393. <P>
  1394. The  ";"  has  a  special  meaning in ALIASes, BINDings and ONs:  it's
  1395. treated  as  command  separator,  that  means  you  can  execute multiple
  1396. commands  in  a  row  separated  by  semicolons.   The semicolons are not
  1397. considered  separators  when  you  use them interactively, (to be able to
  1398. type ";-)"), and within an ircII script file.  You can escape the meaning
  1399. of ";" in an ALIAS with "¥;".
  1400.  
  1401. <P>
  1402. When  you  use  ircII on a (semi)regular basis, you will discover that
  1403. every  time  you start the program you will issue the same initialization
  1404. sequence.  If that is the case, I have good news for you:  you don't have
  1405. to do that anymore!  ircII will, at startup, load a file called ".ircrc",
  1406. (full  path:   $HOME/.ircrc).  It will treat each line in that file as if
  1407. you typed it manually.
  1408.  
  1409. <P>
  1410. For example, if the content of your .ircrc file is:
  1411.  
  1412. <P>
  1413. JOIN #Twilight_Zone
  1414.  
  1415. <P>
  1416. then each time you will start IRC, you will join this channel.
  1417.  
  1418. <P>
  1419. Advanced  commands  may come in handy if you need them.  Feel free to
  1420. browse  in  ircII online help to find out more about them.  A few of them
  1421. are probably worth learning...
  1422.  
  1423. <HR>
  1424. <CENTER><H3>2.9  Sample .ircrc</H3></CENTER>
  1425. <HR>
  1426.  
  1427. <P>
  1428. As a sample, here's part of my .ircrc file.  Since ircII2.2, this file
  1429. can be found in the "script" directory, and loaded with "/load ircprimer"
  1430.  
  1431. <PRE># Sample .ircrc script, from the IRCprimer v1.1
  1432. # -------------------------------------------------------------------
  1433. #    IRCII sample configuration file  (~/.ircrc)  (Nicolas Pioch)
  1434. # -------------------------------------------------------------------
  1435. # The aim of this file is to shorten all useful commands to 1 letter.
  1436.  
  1437. set NOVICE off
  1438. set INPUT_ALIASES off
  1439. set AUTO_WHOWAS on
  1440. set SHOW_CHANNEL_NAMES on
  1441. set SHOW_AWAY_ONCE on
  1442.  
  1443. # Speeds up ircII display 2 times
  1444. set SCROLL_LINES 2
  1445.  
  1446. # Put Hack notices down under
  1447. on ^SERVER_NOTICE "¥*¥*¥* Notice -- Hack: *" set status_user Hack: $4-
  1448.  
  1449. # Modified killpath script from YeggMan
  1450. ALIAS kpath ECHO ### Last received KILL for $nkp.path
  1451. @ nkp.path = [<empty>]
  1452. ALIAS nkp.msg ECHO ### $Z -- KILL by $1 for $0 $2-
  1453. ALIAS nkp.idx @ FUNCTION_RETURN = RINDEX(! $0) + 1
  1454. ALIAS nkp.srv @ FUNCTION_RETURN = INDEX(. $MID($nkp.idx($0) 512 $0))
  1455. ON ^SERVER_NOTICE "¥*¥*¥* Notice -- Received KILL*" <
  1456. #       if (index(. $mid($<rindex(! $11) +1> 512 $11))
  1457.         IF ( nkp.srv($11) > -1 )
  1458.             < nkp.msg $7 $9 >
  1459.             < nkp.msg $7 $9 $12- >
  1460.         @ nkp.path = [$7-]
  1461. >
  1462.  
  1463. # Function to strip the less significant part of an internet hostname
  1464. # $userdomain(username@host.subdomain.dom)  returns username@subdomain.dom
  1465. # This eliminates the hostname which may change frequently
  1466. alias userdomain <
  1467.   @ function_return = LEFT($INDEX(@ $0) $0)##[@]##MID($<1+INDEX(. $0)> 99 $0)
  1468. >
  1469.  
  1470. # Who is that ?
  1471. on ^msg * echo *$0!$userdomain($userhost())* $1-
  1472.  
  1473. # /w [<nickname>]                        get info on someone
  1474. # /q [<nickname>]                        query someone
  1475. # /m  <nickname> <text>                  send a message
  1476. # /n  <nickname> <text>                  send a notice
  1477. # /r <text>                              reply to last message I got
  1478. # /a <text>                              followup on my last message
  1479.  
  1480. alias w whois
  1481. alias q query
  1482. alias m msg
  1483. alias n notice
  1484. alias r msg $,
  1485. alias a msg $.
  1486.  
  1487. # /j <channel>                           join a channel
  1488. # /l <channel>                           list people in a channel
  1489. # /ll                                    list in the current channel
  1490. # /i <nickname> [<channel>]              invite someone
  1491. # /hop                                   leave the current channel
  1492.  
  1493. alias j join
  1494. alias l who
  1495. alias ll who *
  1496. alias i invite
  1497. alias hop part $C
  1498.  
  1499. # /o <nickname> [<nickname> <nickname>]  give channel op status
  1500. # /d <nickname> [<nickname> <nickname>]  remove channel op status
  1501. # /k <nickname>                          kick someone
  1502. # /mo [+|-]<modechars>                   change current channel mode
  1503.  
  1504. alias o mode $C +ooo
  1505. alias d mode $C -ooo
  1506. alias k kick $C
  1507. alias mo mode $C
  1508.  
  1509. # the "wrong person" alias! /oops <nickname> to resend message to
  1510. alias oops <
  1511.         @ _whoops = [$B]
  1512.         msg $. Whooops ! Please ignore, that wasn't meant for you.
  1513.         msg $0 $_whoops
  1514. >
  1515.  
  1516. alias unset set -$*
  1517. alias unalias alias -$*
  1518. alias NickServ msg NickServ@Service.de
  1519. alias NoteServ msg NoteServ@Service.de
  1520.  
  1521. # -------------------------------------------------------------------</PRE>
  1522.  
  1523. <HR>
  1524. <CENTER><H3>2.10  Writing automatons</H3></CENTER>
  1525. <HR>
  1526.  
  1527. <P>
  1528. An  automaton,  (also  called  robot or service), is a program that is
  1529. connected to the IRC network to provide services.  Many people try to set
  1530. that up with a few ircII commands like:
  1531.  
  1532. <P>
  1533. on ^msg "% help" notice $0 This is LameBot 1.0
  1534.  
  1535. <P>
  1536. However,  you  should know that setting up an automaton using ircII ON
  1537. facilities  is  quick  and  dirty, and should be reserved for robots that
  1538. rely  on ircII specific features such as DCC (file servers for instance).
  1539. Writing  a  program  in C, perl or any decent programming language should
  1540. take longer in the beginning, but your efforts will be rewarded.  You can
  1541. download  skeletons  of  such  programs  on  some ftp sites that keep IRC
  1542. related stuff (check in the Frequently Asked Questions part).
  1543.  
  1544. <P>
  1545. Although  most  robots-writers  believe  they  have  created  a "smart
  1546. thing",  99%  of  the  robots  online  happen to be a nuisance to the IRC
  1547. community, because a few simple rules were not respected by their owners.
  1548. The main idea is that robots should neither be seen nor heard:
  1549.  
  1550. <PRE>    * automatons should be clearly identified as such, having "bot",
  1551.       "serv" or "srv" in their nickname.
  1552.  
  1553.     * they should use NOTICES to communicate with the rest
  1554.       of the world, and not reply to NOTICES they get.
  1555.  
  1556.     * they should be able to always be killed (craziness is a
  1557.       frequent disease among robots).
  1558.  
  1559.     * they should be able to be killed remotely by their owner via IRC.
  1560.  
  1561.     * they should not give access to their owner's real files, (bandits
  1562.       have already been able to crack people's accounts through
  1563.       their robots).
  1564.  
  1565.     * they should not send messages to channels (unless the channel
  1566.       is dedicated to that robot).
  1567.  
  1568.    * they should not flood channels with MODE changes. Basically,
  1569.      if you have such a command as:
  1570.  
  1571.         on -JOIN "Lamer #BotTub" mode #BotTub +o Lamer
  1572.  
  1573.   then you are wrong. Because this is what you will get:
  1574.  
  1575. *** Lamer (clueless@where.the.hell) has joined channel #bottub
  1576. *** Mode change "+o Lamer" on channel #bottub by LameBot
  1577. *** Mode change "+o Lamer" on channel #bottub by StupidSrv
  1578. *** Mode change "+ooo Lamer Lamer Lamer" on channel #bottub by FloodServ
  1579. *** Mode change "+o Lamer" on channel #bottub by Dumbbot</PRE>
  1580.  
  1581. <P>
  1582. And  this  will  get  boring  very soon, so don't be surprised if such
  1583. robots  get  banned  from  most channels.  A good kludge is to wait until
  1584. someone  asks explicitly the robot to be opped on a channel.  This could
  1585. be:
  1586.  
  1587. <P>
  1588. on -MSG "Lamer op me on #BotTub" mode #BotTub +o Lamer
  1589.  
  1590. <P>
  1591. If you don't respect rules 2 and 6 above, this may happen too:
  1592.  
  1593. <PRE>*** TalkBot (clueless@where.the.hell) has joined channel #bottub
  1594. <LameBot> Hi TalkBot!
  1595. <TalkBot> Hello LameBot! How are you?
  1596. *** Mode change "+o TalkBot" on channel #bottub by LameBot
  1597. <LameBot> Fine thanx.
  1598. <TalkBot> Thank you for the op, LameBot.
  1599. <LameBot> No problem, TalkBot.
  1600. *** Signoff: Talkbot (ircserver.irc.edu where.the.hell)
  1601. *** TalkBot (clueless@where.the.hell) has joined channel #bottub
  1602. *** Mode change "+o TalkBot" on channel #bottub by where.the.hell
  1603. *** Mode change "+o LameBot" on channel #bottub by TalkBot
  1604. *** Mode change "+o TalkBot" on channel #bottub by LameBot
  1605. <TalkBot> Thank you for the op, LameBot.
  1606. <LameBot> No problem, TalkBot.
  1607. ...
  1608.  
  1609. See?  Remember the golden rule:
  1610.  
  1611.     +--------------------------------------------------------------+
  1612.     | A smart bot won't act unless explicitly asked by someone to. |
  1613.     +--------------------------------------------------------------+</PRE>
  1614.  
  1615. <HR>
  1616. <CENTER><H2>3. FREQUENTLY ASKED QUESTIONS</H2></CENTER>
  1617. <HR>
  1618. <CENTER><H3>3.1  How do I set up an IRC client?</H3></CENTER>
  1619. <HR>
  1620.  
  1621. <P>
  1622. Here  is  a list of FTP sites from which you can download a client for
  1623. your specific Operating System.
  1624.  
  1625. <PRE>Table 15:  FTP sites with IRC clients
  1626. -------------------------------------
  1627.  UNIX ircII
  1628. ~~~~~~~~~~
  1629. cs.bu.edu                      - /irc/clients
  1630. ftp.acsu.buffalo.edu           - /pub/irc
  1631. slopoke.mlb.semi.harris.com    - /pub/irc
  1632. plod.cmbe.unsw.oz.au           - /pub
  1633. coombs.anu.edu.au              - /pub/irc
  1634. nic.funet.fi                   - /pub/unix/irc/ircII
  1635. ftp.informatik.tu-muenchen.de  - /pub/net/irc
  1636.  
  1637. EMACS elisp
  1638. ~~~~~~~~~~~
  1639. cs.bu.edu                       - /irc/clients/elisp
  1640. slopoke.mlb.semi.harris.com     - /pub/irc/emacs
  1641. nic.funet.fi                    - /pub/unix/irc/Emacs
  1642. lehtori.cc.tut.fi               - /pub/irchat
  1643. ftp.informatik.tu-muenchen.de   - /pub/net/irc
  1644.  
  1645. VMS
  1646. ~~~
  1647. cs.bu.edu                       - /irc/clients/vms
  1648. coombs.anu.edu.au               - /pub/irc/vms
  1649. nic.funet.fi                    - /pub/unix/irc/vms
  1650. ftp.informatik.tu-muenchen.de   - /pub/net/irc
  1651.  
  1652. REXX for VM
  1653. ~~~~~~~~~~~
  1654. ftp.informatik.uni-oldenburg.de - /pub/irc/rxirc
  1655. ftp.informatik.tu-muenchen.de   - /pub/net/irc/VM
  1656. cs.bu.edu                       - /irc/clients/rxirc
  1657. coombs.anu.edu.au               - /pub/irc/rxirc
  1658. nic.funet.fi                    - /pub/unix/irc/rxirc
  1659.  
  1660. MSDOS
  1661. ~~~~~
  1662. cs.bu.edu                       - /irc/clients
  1663. nic.funet.fi                    - /pub/unix/irc/msdos
  1664.  
  1665. Macintosh
  1666.  ~~~~~~~~~
  1667. cs.bu.edu                       - /irc/clients
  1668. nic.funet.fi                    - /pub/unix/irc/mac
  1669. sumex.stanford.edu              - /info-mac/comm
  1670. ftp.ira.uka.de                  - /pub/systems/mac</PRE>
  1671.  
  1672. <P>
  1673. For  Unix  machines,  you  either compile the source yourself, or have
  1674. someone  else  on  your  machine compile the source for you.  The current
  1675. "official"  ircII release is version 2.2.1. That means that it is said to
  1676. be quite bugfree (Hehe, you never know...) In addition to this "official"
  1677. distribution,  you  may  find  preversions of the client to come floating
  1678. around,  for people who like to track down bugs and taste things to come.
  1679. However,  you  should be aware of that those clients are being worked on,
  1680. and may not have full features working properly.
  1681.  
  1682. <P>
  1683. Here are the commands to type to setup an ircII client:
  1684.  
  1685. <PRE>        ~ > ftp
  1686.         ftp> verbose off
  1687.         Verbose mode off.
  1688.         ftp> open cs.bu.edu
  1689.         Name (cs.bu.edu:yourname) : ftp
  1690.         Password: yourname@yourhost
  1691.         ftp> cd irc/clients
  1692.         ftp> bin
  1693.         ftp> get ircII2.2.1.2.tar.Z "|zcat|tar xf -"
  1694.         ftp> get ircII2.2.1help.tar.Z "|zcat|tar xf -"
  1695.         ftp> quit
  1696.         ~ ></PRE>
  1697.  
  1698. <P>
  1699. You now have to go into ircII2.2.1 and read the files  explaining  how
  1700. to achieve a successful installation.  Have a look at README and INSTALL,
  1701. edit   config.h   to  define  DEFAULT_SERVER,  edit  Makefile  to  define
  1702. INSTALL_EXECUTABLE,  IRCII_LIBRARY  and the C compiler you will be using,
  1703. then type make install and wait...
  1704.  
  1705. <P>
  1706. If  you  can't set up a client on any local machine, you can still use
  1707. any telnet client:
  1708.  
  1709. <PRE>Table 16:  Open telnet clients
  1710. ------------------------------
  1711. Area      Command                                 login name
  1712. ~~~~      ~~~~~~~                                 ~~~~~~~~~~
  1713. America   telnet bradenville.andrew.cmu.edu
  1714.           telnet chatsubo.nersc.gov               bbs
  1715.  
  1716. Asia      telnet cc.nsysu.edu.tw                  irc
  1717.  
  1718. Europe    telnet ircclient.itc.univie.ac.at 6668
  1719.           telnet irc.ibmpcug.co.uk 9999</PRE>
  1720.  
  1721. <P>
  1722. Please  only use telnet when you have no other way of reaching IRC, as
  1723. this resource is quite limited.
  1724.  
  1725. <HR>
  1726. <CENTER><H3>3.2  Which server do I connect to?</H3></CENTER>
  1727. <HR>
  1728.  
  1729. <P>
  1730. It's usually best to try and connect to one geographically close, even
  1731. though that may not be the best.  You can always ask when you get on IRC.
  1732. Here's a list of servers available for connection:
  1733.  
  1734. <PRE>Table 17:  Open IRC servers
  1735. ---------------------------
  1736. America   Canada        ug.cs.dal.ca
  1737. ~~~~~~~   USA           csa.bu.edu
  1738.                         ucsu.coloradu.edu
  1739.                         irc.caltech.edu
  1740.  
  1741. Europe    Finland       nic.funet.fi
  1742. ~~~~~~    France        poly.polytechnique.fr
  1743.           Germany       noc.belwue.de
  1744.           Sweden        irc.nada.kth.se
  1745.  
  1746. Oceania   Australia     munagin.ee.mu.oz.au</PRE>
  1747. ~~~~~~~
  1748.  
  1749. <P>
  1750. This  is  by  no  means,  a  comprehensive  list,  but merely a start.
  1751. Connect   to   the   closest  of  these  servers  and  join  the  channel
  1752. #Twilight_Zone  or, if you are in Europe, #EU-Opers.  When you are there,
  1753. immediately  ask  what  you  want.  Don't say "I have a question" because
  1754. then  everyone  will  ignore  you  until you say it a few times, and then
  1755. they'll jump down your throat and rip your lungs out.  No one knows if he
  1756. can answer your question until you ask it.
  1757.  
  1758. <HR>
  1759. <CENTER><H3>3.3  What are good channels to try while using IRC?</H3></CENTER>
  1760. <HR>
  1761.  
  1762. <P>
  1763. #Hottub  and #initgame are almost always teeming with people.  #Hottub
  1764. is  meant  to  simulate  a  hot  tub, and #initgame is a non-stop game of
  1765. "inits"  (initials).   Just join the fun and find out!  (German users may
  1766. try channels named after German university towns...)
  1767.  
  1768. <P>
  1769. Many  IRC  Operators  are  in #Twilight_Zone, while European Operators
  1770. concentrate in #EU-Opers...  So if you join an Operator channel and don't
  1771. hear  much  talking,  don't worry, it's not because you joined, Operators
  1772. don't talk much on such channels anyways!
  1773.  
  1774. <HR>
  1775. <CENTER><H3>3.4  How do I get nifty effects with ircII?</H3></CENTER>
  1776. <HR>
  1777.  
  1778. <P>
  1779. You  can  highlight  messages  you send using control chars:  parts of
  1780. text  surrounded  by  control-b (^B) will appear in video reverse to most
  1781. ircII  users for instance.  However the appearance of such effects relies
  1782. on the terminal abilities of the user you're writing to.
  1783.  
  1784. <P>
  1785. In  some  cases keys are already bound to something.  For instance, ^B
  1786. is  normally  bound  to  BACKWARD_CHARACTER, so you will need to define a
  1787. "quote-character" key:  just enter "/BIND ^W QUOTE_CHARACTER" then "/BIND
  1788. ^W^B SELF_INSERT" and it may work...
  1789.  
  1790. <PRE>Table 18:  Highlighting ircII output
  1791. ------------------------------------
  1792. Key  Effect
  1793. ~~~  ~~~~~~
  1794. ^B   Video reverse
  1795. ^V   Underline
  1796. ^_   Bold</PRE>
  1797.  
  1798. <HR>
  1799. <CENTER><H3>3.5  What if someone tells me to type something cryptic?</H3></CENTER>
  1800. <HR>
  1801.  
  1802. <P>
  1803. NEVER  type  anything  anyone tells you to without knowing what it is.
  1804. There  is  a  problem with typing a certain command with the ircII client
  1805. that  gives  anyone immediate control of your client, (and thus can alter
  1806. your account environment also).  Look in the ircII on-line help each time
  1807. you can.
  1808.  
  1809. <HR>
  1810. <CENTER><H3>3.6  I get strange characters on my screen, what are they?</H3></CENTER>
  1811. <HR>
  1812.  
  1813. <P>
  1814. IRC  has quite a lot of people from Scandinavian countries, ><|][¥ are
  1815. letters  in  their  alphabet  (IRC is supposed to support the ISO Latin-1
  1816. 8-bit  character  set,  but your client  must be able to display them...)
  1817. This  has  been  explained on IRC about a thousand and one times, so read
  1818. the following, do not ask it on IRC:
  1819.  
  1820. <PRE>Table 19:  Nordic countries character translations
  1821. --------------------------------------------------
  1822. Character  Description
  1823. ~~~~~~~~~  ~~~~~~~~~~~
  1824. [, <       'a' with two dots over it
  1825. ], >       'a' with a small circle above it
  1826. ¥, |       'o' with two dots over it, or a dash ("/") through it
  1827.          ("[", "]", and "¥" = upper case)</PRE>
  1828.  
  1829. <P>
  1830. In  addition  to  that,  Japanese  IRC'ers  use  a special ANSI escape
  1831. control  sequences  to transmit their Kanji alphabet.  This may also look
  1832. funny  if  you  get  some  of it...  Here's a sample:  [$B$?$K$7[$B;$m$K#
  1833. (nice, uh?)
  1834.  
  1835. <HR>
  1836. <CENTER><H3>3.7  What about NickServ?</H3></CENTER>
  1837. <HR>
  1838. <P>
  1839. To  quote  from  NickServ's  help  text, NickServ's purpose is to help
  1840. avoiding  nickname confusions on IRC.  There's no such thing as "nickname
  1841. ownership",  however NickServ sends a warning to anyone else who signs on
  1842. with  your  nickname.   If  you don't use IRC for 10 weeks, your nickname
  1843. registration expires for reuse.
  1844.  
  1845. <P>
  1846. Only  a  NickServ operator can change your NickServ password.  To find
  1847. out which NickServ operators are on-line, send
  1848.  
  1849. <P>
  1850. /MSG NickServ@Service.de OPERWHO
  1851.  
  1852. <P>
  1853. Nicknames with a "*" next to them are online at the time.
  1854.  
  1855. <HR>
  1856. <CENTER><H3>3.8  I'm being flooded or harassed by a jerk. HELP!</H3></CENTER>
  1857. <HR>
  1858.  
  1859. <P>
  1860. If  somebody is behaving like a jerk on IRC, like dumping to a channel
  1861. Mb's  of garbage, then he should be KICKed and eventually banned from the
  1862. channel, (see "/HELP MODE" for details).
  1863.  
  1864. <P>
  1865. If  it's a matter of personal harassment, then you should set a proper
  1866. IGNORE on that person, (preferably on his userid@hostname).  Remember you
  1867. can use wildcard expressions for IGNORE.  More about this in section 2.2.
  1868.  
  1869. <HR>
  1870. <CENTER><H3>3.9  How do I get rid of a ghosted IRC session?</H3></CENTER>
  1871. <HR>
  1872.  
  1873. <P>
  1874. Sometimes  you  may  have  a  "ghosted"  IRC  session, a process still
  1875. running  on  your machine you would like to get rid of, but can't control
  1876. anymore to issue a QUIT command.  Going back to a unix shell, try listing
  1877. your processes:  ("ps -ux" or "ps -f" depending on your system)
  1878.  
  1879. <PRE>    poly ~ > ps -ux
  1880.     USER       PID  %CPU %MEM   SZ  RSS TT STAT TIME COMMAND
  1881.     pioch    10410   1.4  0.2  839  402 pf S    0:00 /usr/local/bin/emacs
  1882.     pioch    25441   0.6  0.9 2888 1908 ?  S    0:32 xterm -ls
  1883.     pioch    25444   0.4  0.2  550  341 pf S    0:17 -tcsh (tcsh)
  1884.     pioch    10404   0.1  0.3  897  624 pf S    0:00 irisVx 5 4 10403
  1885.     pioch    25634   0.0  0.3 1022  678 p6 S    0:22 irc
  1886.     pioch    25451   0.0  0.2  953  326 ?  S    0:07 xmailbox
  1887.     pioch    25452   0.0  0.1  386  147 ?  S    0:00 xdaliclock
  1888.     pioch    25459   0.0  0.3 1109  617 ?  S    0:02 xman
  1889.     pioch    10403   0.0  0.1  574  124 pf I    0:00 mapleV
  1890.     pioch    10423   0.0  0.2  614  459 pf R    0:00 /bin/ps -ux</PRE>
  1891.  
  1892. <P>
  1893. Locate the line about your lost IRC session, (irc should appear in the
  1894. COMMAND field of the line), and its PID, (process number, second field of
  1895. the line here).  In this example the PID is 25634, as shown here:
  1896.  
  1897. <PRE>    USER       PID  %CPU %MEM   SZ  RSS TT STAT TIME COMMAND
  1898.     pioch    25634   0.0  0.3 1022  678 p6 S    0:22 irc</PRE>
  1899.  
  1900. <P>
  1901. All  you  then  need  to  type is "kill -KILL" or "kill -9" immediatly
  1902. followed by the PID found above:  "kill -kill 25634" here.
  1903.  
  1904. <P>
  1905. You  can  get  more  details  about  the commands involved here in the
  1906. standard unix manual, ("man 1 ps" or "man 1 kill").
  1907.  
  1908. <P>
  1909. If  your  machine  crashed,  and  your nick is still in use on the IRC
  1910. network,  you'll have to wait 4 to 5 minutes for your server to recognize
  1911. the  fact.   Getting  an  Operator  to  kill  the  ghost  is almost never
  1912. necessary,  just  sign  on  as  another  nickname  and wait for the "Ping
  1913. timeout" or "Bad link" message, then you can change your nick back...
  1914.  
  1915. <HR>
  1916. <CENTER><H3>3.10  About KILL Usage</H3></CENTER>
  1917. <HR>
  1918.  
  1919. <P>
  1920. KILL  is  a  command restricted to IRC-Operators to deal with protocol
  1921. errors  heavily  reducing the IRC network functionality.  It's to be used
  1922. with extreme caution, if at all.
  1923.  
  1924. <PRE>      +-----------------------------------------------------------+
  1925.       | KILL should never interfere with channel-operator status. |
  1926.       +-----------------------------------------------------------+</PRE>
  1927.  
  1928. <P>
  1929. If you op someone on a channel, you take the consequences.  If someone
  1930. joins  #Whatever,  you  op  them,  then  they  kick everyone and lock the
  1931. channel  with  some  "Mode  change +ib *!*@*", then suffer it:  it's your
  1932. fault,  don't go whining to an IRC-op to fix it.  If a channel is locked,
  1933. you should start a new one.
  1934.  
  1935. <P>
  1936. Effective  methods  to deal with obnoxious people are IGNORE, KICK and
  1937. various MODEs on channels, such as +i and/or +b.
  1938.  
  1939. <P>
  1940. If  you  have  been  abusively  killed by an IRC-Operator, abusing his
  1941. power to gain illegal channel-operator status for instance, yell!  Mail a
  1942. log  to his server IRC-Administrator, (see ADMIN), join #Twilight_Zone or
  1943. #EU-Opers for European-related problems, and explain what happened.
  1944.  
  1945. <HR>
  1946. <CENTER><H3>3.11  Where can I find more?</H3></CENTER>
  1947. <HR>
  1948.  
  1949. <P>
  1950. Should  your  question  not be listed above, you may want to check the
  1951. "Frequently  Unasked  Questions", (FUQ) list, which will be shipping real
  1952. soon now, featuring replies to:
  1953.  
  1954. <PRE>        <lamer1> Are there any good FTP sites? (1)
  1955.         <lamer2> How do I join a channel?
  1956.         <lamer3> How do I become an IRCop?</PRE>
  1957.  
  1958. <P>
  1959. If you have access to Usenet News, (usually through a program called
  1960. rn, trn, xrn or nn), you may want to join alt.irc debates, flamings and
  1961. whinings.
  1962.  
  1963. <P>
  1964. You can also join various IRC related mailing lists.  "Operlist"
  1965. discusses  current  (and  past)  server code, routing and protocol.  Mail
  1966. operlist-request@eff.org     to     join.     Another    mailing    list,
  1967. ircd-three@eff.org  exists  to  discuss  protocol  revisions  for the 3.0
  1968. release  of ircd, currently in planning.  Mail ircd-three-request@eff.org
  1969. to  be  added to that.  There is also low-traffic mailing-lists for ircII
  1970. vmsirc and irchat clients.
  1971.  
  1972. <PRE>Table 20:  IRC related mailing lists
  1973. ------------------------------------
  1974. E-mail for subscriptions       What's being talked about
  1975. ~~~~~~~~~~~~~~~~~~~~~~~~       ~~~~~~~~~~~~~~~~~~~~~~~~~
  1976. operlist-request@eff.org       Server code, routing and protocol.
  1977. ircd-three-request@eff.org     ircd 3.0 protocol
  1978. listserv@grasp1.univ.lyon1.fr  European IRC-Operators mailing list
  1979. dl2p+@andrew.cmu.edu           ircII mailing list
  1980. vmsirc-request@vax1.elon.edu   VMS IRC mailing list
  1981. irchat-request@cc.tut.fi       irchat mailing list
  1982.  
  1983. ((1) 129.0.0.1 but you already know that.)</PRE>
  1984.  
  1985. <HR>
  1986. <CENTER><H2>4.  ADMINISTRATIVIA</H2></CENTER>
  1987. <HR>
  1988. <CENTER><H3>4.1  Revision history</H3></CENTER>
  1989. <HR>
  1990. <P>
  1991. This  is  version 1.1 of this paper.  Version 1.0 of the IRCprimer was
  1992. released  in  postscript  form  in June 1992 because I was sick of people
  1993. asking  for  an  IRC  or  ircII  manual  (and  it was a good way to learn
  1994. LaTeX!).   During  summer  1992  Owe  Rasmussen  did  a  very  nice  text
  1995. conversion  of  the  paper.  Due to the support and many remarks I got, a
  1996. new version  is finally completed  (special thanks to Olaf Titz !), along
  1997. with Owe's plain ascii conversion.
  1998.  
  1999. <P>
  2000. The primer is available in 3 formats:
  2001.  
  2002. <P>
  2003. IRCprimer.ps.Z:   Postscript version<BR>
  2004. IRCprimer.txt:    Plain text version<BR>
  2005. IRCprimer.tex.Z:  Source code.
  2006.  
  2007. <HR>
  2008. <CENTER><H3>4.2  Release sites for the IRCprimer</H3></CENTER>
  2009. <HR>
  2010.  
  2011. <P>
  2012. The  latest  version  of  the primer can be found on the following ftp
  2013. sites, thanks to their admins:
  2014.  
  2015. <PRE>Table 21: IRCprimer release sites
  2016. ---------------------------------
  2017. ftp site           location
  2018. ~~~~~~~~           ~~~~~~~~
  2019. nic.funet.fi       /pub/unix/irc/docs
  2020. cs.bu.edu          /irc/support
  2021. coombs.anu.edu.au  /pub/irc/docs</PRE>
  2022.  
  2023. <P>
  2024. Here's how to get the latest primer postscript version for example:
  2025.  
  2026. <PRE>        ~ > ftp
  2027.         ftp> verbose off
  2028.         Verbose mode off.
  2029.         ftp> open cs.bu.edu
  2030.         Name (cs.bu.edu:yourname): ftp
  2031.         Password: yourname@yourhost
  2032.         ftp> cd irc/support
  2033.         ftp> bin
  2034.         ftp> get IRCprimer.ps.Z
  2035.         ftp> quit
  2036.         ~ > uncompress IRCprimer.ps.Z
  2037.         ~ ></PRE>
  2038.  
  2039. <HR>
  2040. <CENTER><H3>4.3  Copyright (C) 1993 Nicolas PIOCH</H3></CENTER>
  2041. <HR>
  2042.  
  2043. <P>
  2044. This  manual  is  free; you can redistribute it and/or modify it under
  2045. the  terms  of  the  GNU  General Public License as published by the Free
  2046. Software Foundation; either version 2 of the license, or (at your option)
  2047. any later version.
  2048.  
  2049. <HR>
  2050. <CENTER><H3>4.4  Credits</H3></CENTER>
  2051. <HR>
  2052.  
  2053. <P>
  2054. Interesting  informations  contained in this paper are due to the work
  2055. of various people interested in IRC improvement; I'm only responsible for
  2056. omissions and mistakes :-)
  2057.  
  2058. <P>
  2059. It's  impossible  to  give here a full list, however special thanx are
  2060. due to (in alphabetical order):
  2061.  
  2062.  <PRE> +---------------------------------------------------------------------+
  2063.  |   Real life (uh ?)       IRC          E-mail                        |
  2064.  |   ~~~~~~~~~~~~~~~~       ~~~          ~~~~~~                        |
  2065.  |   Christopher Davis      ckd          ckd@eff.org                   |
  2066.  |   Christophe Wolfhugel   Zolf         wolf@grasp.insa-lyon.fr       |
  2067.  |   Darren Reed            Avalon       avalon@coombs.anu.edu.au      |
  2068.  |   Greg Lindahl,          Wumpus       gl8f@virginia.edu             |
  2069.  |   Helen Rose             Trillian     hrose@eff.org                 |
  2070.  |   Ian Frechette          Daemon       frechett@spot.colorado.edu    |
  2071.  |   Jarkko Oikarinen       WiZ          jto@tolsun.oulu.fi            |
  2072.  |   Jeff Trim                           jtrim@orion.cair.du.edu       |
  2073.  |   Jonathon E. Tidswell   Ernie        jont@cs.su.oz.au              |
  2074.  |   Karl Kleinpaste        poptart      KarlKleinpaste@cs.cmu.edu     |
  2075.  |   Matthew Alderson       thecure      thecure@mullian.ee.mu.oz.au   |
  2076.  |   Matthew Green          phone        phone@coombs.anu.edu.au       |
  2077.  |   Mauri Haikola          Mauri        mjh@stekt.oulu.fi             |
  2078.  |   Michael Sandrof        BigCheese    ms5n+@andrew.cmu.edu          |
  2079.  |   Olaf Titz              praetorius   stitz@ira.uka.de              |
  2080.  |   Ove Ruben R. Olsen     Gnarfer      rubenro@viggo.blh.no          |
  2081.  |   Ronald van Loon        rvl          rvloon@cv.ruu.nl              |
  2082.  |   Troy Rollo             Troy         troy@cbme.unsw.edu.au         |
  2083.  +---------------------------------------------------------------------+</PRE>
  2084. <HR>
  2085. <HR>
  2086. <CENTER><A HREF=00-Table_Of_Contents><IMG SRC=TABLEOFC.GIF></A> <H3>Click To Return To The Table Of Contents.</H3></CENTER>
  2087. <HR>
  2088. </BODY></HTML>
  2089.